Royalty Templates 分润模板
通过创建 royalty_template
对象来设置一个分润模板。分润模板定义了分润的规则,在创建 order
时传入 royalty_template
对象的 id
,在订单付款完成和退款完成时,Ping++ 会根据模板的规则计算分润的用户和金额完成清分。 分润模板依赖于订单层级链,只能给层级链上的商户分润。如果分润规则复杂或者需要给个人用户分润,则分润模板不适用。
属性 | 描述 |
---|
id string | 分润模板对象 ID,由 Ping++ 生成。 |
object string | 值为 royalty_template 。 |
app string | 对应 app 对象的 id ,查看如何获取App ID。 |
name string | 分润模板名称,允许中英文等常用字符,取值范围 2~50 位。 |
created timestamp | 创建时间,用 Unix 时间戳表示。 |
rule[royalty_mode] string | 分润模式。值为 rate 表示按订单金额(包含优惠券金额)比例计算;值为 fixed 表示按固定金额收取分润。 |
rule[refund_mode] string | 退分润模式。值为 no_refund 表示不退分润;值为 proportional 表示按退款占支付的比例退分润;值为 full_refund 表示一旦退款成功分润全退。 |
rule[allocation_mode] string | 分配模式。表示当订单确定的层级如果少于模板配置层级时,模板中计算出的多余分润金额是归属于收款方:receipt_reserved 或服务方:service_reserved 。 |
rule[data] list | 分润数据列表,详见下方 rule[data] 列表属性说明。 |
description string | 附加说明,最多 100 个 Unicode 字符。 |
rule[data] 列表属性 | 描述 |
---|
level integer | 商户层级,值为 0~5,其中 "0" 表示平台。 |
value integer | 分润数值。royalty_mode 为 rate 时,取值范围 0~10000,单位为 0.01%;royalty_mode 为 fixed 时,取值范围 0~1000000,单位为分。 |